ποΈGitΠ―ΡΠ°ποΈ
docs/srp/user/nodes.md renovate/fastlane-2.x-lockfile (423f9d44) Text, 20.41 KB
title: Π§Π²ΠΎΡΠΎΠ²ΠΈ
parent: User Guide
nav_order: 4
last_updated: 2026-09-11
description: Browse, filter, and sort mesh nodes β view details, signal quality, roles, and quick actions.
aliases:
β’ node-list
β’ mesh-nodes
β’ peers
β’ hop-histogram
Π§Π²ΠΎΡΠΎΠ²ΠΈ
The Nodes screen lists every node visible on your mesh.
Node List
The node list shows every node your radio has heard, including:
β’ Node name β user-configured long name
β’ Short name β 4-character identifier
β’ Signal quality β SNR, RSSI, and a quality word, shown only for nodes your radio heard directly. In the Complete layout a node reached through a relay shows its hop count here instead; a node heard only over MQTT shows neither
β’ Last heard β time since last communication
β’ Distance β estimated distance (if positions are shared)
β’ Battery β remote node battery level (if telemetry is enabled)
Choosing What the List Shows
The list has two densities, set at Settings β Node Layout. Complete shows every field a node has reported and hides the ones it hasn't. Compact fits more nodes on screen and lets you pick the fields yourself β Power, Last Heard Time, Relative Last Heard Time, Distance and Bearing, Hops Away, Signal (Direct Only), Channel, and Device & Role. The Environment Metrics toggle applies to both densities. A preview above the toggles shows the effect before you leave the screen.
Node Status Indicators
βββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββ
β Indicator β Meaning β
βββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββ€
β Green last-heard time β Node heard within the last 2 hours β
β Plain last-heard time β Node not heard for over 2 hours β
β β Favorite β Node you marked as a favorite. β
βββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββ
There is no separate "away" tier.
Node Roles
Nodes can be configured with different roles that affect their mesh behavior:
ββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Π£Π»ΠΎΠ³Π° β ΠΠΏΠΈΡ β
ββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ΠΠ»ΠΈΡΠ΅Π½Ρ β Standard end-user node β
β Client Base β Treats favorited-node traffic as Router Late priority; all other traffic aβ¦ β
β ΠΠ»ΠΈΡΠ΅Π½Ρ ΠΌΡΡΠΈΡΠ°Π½ β Receives but doesn't retransmit β
β Π‘ΠΊΡΠΈΠ²Π΅Π½ΠΈ ΠΊΠ»ΠΈΡΠ΅Π½Ρ β Like Client Mute, plus hides from node list β
β Π ΡΡΠ΅Ρ β Prioritizes message forwarding; stays awake to relay β
β Π ΡΡΠ΅Ρ ΡΠ° ΠΊΠ°ΡΡΠ΅ΡΠ΅ΠΌ β Infrastructure node that rebroadcasts once, but only after all other modesβ¦ β
β ~~Router Client~~ β β οΈ Deprecated (removed in firmware 2.3.15) β no longer selectable; use Rouβ¦ β
β ~~Repeater~~ β β οΈ Deprecated (removed in firmware 2.7.11) β no longer selectable; use Rouβ¦ β
β Π’ΡΠ΅ΠΊΠ΅Ρ β Optimized for position reporting at regular intervals β
β Π‘Π΅Π½Π·ΠΎΡ β Optimized for telemetry reporting β
β TAK β Interoperates with TAK systems (sends/receives CoT) β
β Π’ΠΠ Π’ΡΠ΅ΠΊΠ΅Ρ β TAK position reporting only β
β ΠΠ·Π³ΡΠ±ΡΠ΅Π½ΠΎ ΠΈ Π½Π°ΡΠ΅Π½ΠΎ β Sends its position to the default channel as a text message at regular intβ¦ β
ββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Choosing a Role
Most users should keep the default Client role. Consider a different role when:
β’ Router β You have a node in a fixed, elevated location with reliable power (rooftop, hilltop). Routers stay awake continuously to relay messages for others and are essential for extending mesh coverage. Don't use Router on battery-powered handheld radios.
β’ Router Late β An infrastructure node that always rebroadcasts packets once but only after all other routing modes have had their turn. Provides supplemental coverage for local clusters without competing with primary routers.
β’ Client Base β Treats traffic from/to your favorited nodes with Router Late priority (ensuring those messages get extra relay coverage) while handling everything else as a normal Client.
β’ Client Mute β You want to receive mesh traffic but not contribute to relaying. Useful for monitoring-only radios or to reduce congestion in dense areas.
β’ Tracker β An unattended radio whose sole purpose is broadcasting its GPS position (e.g., a vehicle, pet, or asset). Sleeps between broadcasts to conserve battery.
β’ Sensor β An unattended radio reporting environmental telemetry (temperature, humidity, air quality). Similar power profile to Tracker.
β’ TAK / TAK Tracker β Only needed if interoperating with ATAK/WinTAK systems. See TAK Integration for details.
β π‘ Tip: The mesh works best when most nodes are Client or Router. Too many Client Mute nodes
β reduce mesh resilience; too many Routers in a dense area can cause congestion. A good rule of
β thumb: one Router per 5β10 Clients in your area.
Security indicators
Each node carries one security icon beside its name in the node list. Tap it to read what it means, and choose Show All Meanings in that dialog for the full legend. The detail screen shows the same state in words, as a Security row that opens the same dialog.
ββββββββββββββββββββββββββββββββββββββββββ¬ββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ΠΠΊΠΎΠ½ΠΈΡΠ° β Meβ¦ β Shown for β
ββββββββββββββββββββββββββββββββββββββββββΌββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Person with a shield check (green) β Veβ¦ β Any firmware version β
β Nodes icon with a shield check (green) β Siβ¦ β Firmware 2.8 or newer, and any node whose signedβ¦ β
β π Closed lock β A β¦ β Firmware before 2.8, or no reported version β
β π Open lock β Noβ¦ β Firmware before 2.8, or no reported version β
β β οΈ Mismatch β Puβ¦ β Any firmware version β
ββββββββββββββββββββββββββββββββββββββββββ΄ββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββ
Every node on firmware 2.8 or newer signs its broadcasts, so on that firmware the signed state is the baseline and the locks are not shown.
Direct messages always use public-key encryption, so your node needs the other node's public key before it can send one. It refuses the send rather than falling back to channel encryption. Keys arrive inside node info, which is why an open lock usually clears itself once that node is heard from properly.
A mismatch never replaces the key you already hold. The app keeps the first key it recorded and refuses the new one, as the firmware does, so a stray or hostile node info cannot silently break encrypted messaging to a contact. To clear a mismatch, first confirm through another trusted channel that the key change was intentional β a factory reset causes one. Then touch & hold the node, choose Remove, and let the two nodes exchange keys again the next time yours hears it.
Quick Actions
From the node list, you can:
β’ Tap a node to view its detail page
β’ Touch & hold for quick actions:
β’ Mark/remove favorite
β’ Mute/unmute notifications
β’ Send a direct message
β’ Trace route
β’ Ignore/unignore
β’ Π£ΠΊΠ»ΠΎΠ½ΠΈ
Touch & hold your own node instead and you get one action, Update status, which opens the
User settings screen with the cursor already in the Status Message field. It only appears while the
radio is connected and running firmware 2.8 or newer β see
Settings β Radio & User for the field itself.
Sharing a Contact
On a node's detail screen, tap Share Contact to produce a link and a QR code for that node. From the same dialog, Share link opens the Android share sheet (on desktop it copies the link instead), Write to NFC tag saves it to a writable NFC tag, and Copy puts it on the clipboard. While that dialog is open and in front of you, the phone also offers the same link to any NFC reader, so someone can take the contact by tapping their phone against yours with no tag involved.
Sharing your own contact this way marks it as verified in person, so whoever imports it sees the Verified contact icon rather than the signed one. Relaying someone else's contact passes on only what your app had already recorded about them.
To add someone else's contact, use the import button on the node list and choose Scan Shared Contact QR Code, Scan Shared Contact NFC, or Input Shared Contact URL. The app asks you to confirm with Import Shared Contact?, and warns you when the contact is one you already have.
Filtering & Sorting
Text Search
Type in the search field to filter nodes by name or short name. The filter updates in real time as you type.
Filter Toggles
βββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Π€ΠΈΠ»ΡΠ΅Ρ β ΠΠΏΠΈΡ β
βββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Hide offline nodes β Show only nodes heard within the last 2 hours β
β Only show direct nodes β Show only nodes your radio heard directly, with no relay in between β
β Include unknown β Show nodes that haven't sent user info yet. On by default, so a node β¦ β
β Exclude infrastructure β Hide infrastructure-role nodes (Router, Router Late, Client Base, andβ¦ β
β Exclude MQTT β Hide nodes heard only via MQTT internet bridge β
β Signed only β Show only nodes whose signed broadcasts your node has actually heard β¦ β
β Encrypted only β Show nodes with a matching public key on file, the key an encrypted dβ¦ β
β Only show ignored Nodes β Replace the list with the nodes you have ignored. Every other node isβ¦ β
βββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Sort Options
ββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββ
β Sort β ΠΠΏΠΈΡ β
ββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Last heard β Most recently heard nodes first β
β A-Z β Sorted by node long name β
β Distance β Nearest nodes first (requires position sharing) β
β Hops away β Fewest relay hops first β
β Channel β Grouped by channel index β
β via MQTT β Grouped by MQTT vs. radio-heard β
β via Favorite (default) β Favorited nodes first, then the rest β
ββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββ
Nodes per Hop
Tap the hop-histogram icon in the node list's app bar to open a bar chart of how many nodes sit at each hop distance (0 = direct, 1 = one relay away, and so on). Filter the chart to a last heard window β All time, 1 hour, 8 hours, or 24 hours β to see how the mesh looks right now versus over a longer period. It's a quick way to gauge how busy and spread out your local mesh is.
Node Detail
Tapping a node opens the detail view with comprehensive information. See Node Metrics for full details on metrics and telemetry.
Signal quality is rated against your modem preset. The same SNR can be good on a long-range preset and poor on a faster one. Traceroute and neighbor-info SNR colors use that preset too. RSSI text has its own strength colors; it affects the quality rating only when a noise-floor reading is also available.
The Details card carries the node's short name, role, IDs, last heard time, hops away, uptime, and its SNR and RSSI:
Inline status indicators show key metrics at a glance:
ββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Indicator β Screenshot β
ββββββββββββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β’ Searching for nodes β the radio is connected and listening, but nothing has arrived yet. Check that its region and modem preset match the mesh around you, and leave Include unknown on so a node that has not yet sent its name still appears. See Settings β Radio & User.
β’ A node you expect is missing β check the filter toggles. Only show direct nodes, Exclude MQTT, and Exclude infrastructure each hide a whole category of node.
Related Topics
β’ Node Metrics β detailed telemetry dashboards for each node
β’ Messages & Channels β send a direct message to a node
β’ Map & Waypoints β view node positions geographically
β’ Local Mesh Discovery β traceroute and neighbor info for topology exploration
β’ Signal Meter β understand what the signal bars mean
Served by rngit 1.5.4 - Generated in 0.15s